home *** CD-ROM | disk | FTP | other *** search
/ Ultimedia 1 / Ultimedia 1.iso / tools / soundtools / playsid / playsid.doc < prev    next >
Text File  |  1993-04-16  |  12KB  |  351 lines
  1.  
  2.     PLAYSID V2.2        (C)1990,91,92,93 Håkan Sundell & Ron Birk
  3.  
  4.     Release date: 12th April 1993
  5.  
  6. NOTE:
  7.  
  8.     From version 2.1 of PlaySID kickstart 2.04 (v37) or above is
  9.     required! That is becuse it make heavy use of Release 2 System
  10.     routines.
  11.  
  12.     This is SHAREWARE, not Public Domain. That means that if you like
  13.     this program and want further updates, you can be a registered
  14.     owner if you send us a ~$15. It also means that you can spread
  15.     this program only if all files (including this) are included, and
  16.     nothing is changed. You are not allowed to replicate any portion
  17.     of the program, both code or data. Note also that we take no
  18.     responsibilities for the use of this program considering any
  19.     damage to or failure of your hardware, software etc.
  20.  
  21.     If you just like the program please let us know so by sending
  22.     a postcard or similiar to the address below.
  23.  
  24.  
  25. NEW FEATURES:
  26.  
  27.     V2.2
  28.  
  29.     * Powerpacker support
  30.     * New one-file support
  31.  
  32.     V2.1
  33.  
  34.     * Gadtools controlled workbench window
  35.     * Appwindow
  36.     * Arexx port
  37.     * Keyboard shortcuts
  38.     * Rewind Button
  39.     * Open Button
  40.     * Pause Button
  41.     * Jukebox (arexx)
  42.     * Preview (arexx)
  43.     * Faster emulation of 6502
  44.     * Faster and enhanced emulation of waveforms
  45.     * Faster emulation of ringmodulation/synchronize
  46.     * Emulation of undocumented 6502 instructions
  47.     * Enhanced Tool-type format
  48.  
  49.  
  50. PRODUCT INFO:
  51.  
  52.     This is a utility which emulates the SID and 6510 chip. The
  53.     SID chip is the component in the C64 computer that handles sound.
  54.     The 6510 chip is the CPU of the C64, that means the component
  55.     that actually executes all programs. Because the Amiga does
  56.     not have these chips and others, you can't run C64 programs
  57.     directly on Amiga.
  58.  
  59.     Now this utility lets you play all those C64 programs that
  60.     produce sound. As you probably know, the C64 has three sound
  61.     channels (the amiga has four). But this utility also allows
  62.     use of the fourth channel. This channel is the product of
  63.     some special programming on the C64, it isn't really a channel.
  64.  
  65.     The purpose of this product is to make the best conversion
  66.     of C64 sound on Amiga ever possible. If you think some sound
  67.     isn't correctly converted please let us know.
  68.  
  69.     This utility is designed to work with true multitasking, under
  70.     any system version and any amiga model. It can be run from both
  71.     Workbench and CLI/Shell. It should work with any other program
  72.     that don't use sound or timing. If this isn't the fact please
  73.     let us know.
  74.  
  75.     Some time ago we released a similar product called "The 100 most
  76.     remembered C64 game-tunes". This product is the version 2.1
  77.     of that program. The tunes on that demonstration disk are now
  78.     also available to this version. And up to date there are more
  79.     than 400 tunes available. We and others are also working with more.
  80.  
  81.  
  82. PROGRAM INSTALLATION:
  83.  
  84.     To use this utility from Workbench you should assign SID: to a 
  85.     directory containing PlaySID. Then all you have to do is to
  86.     double click on the icon of the tune you want to play. Otherwise
  87.     you could just select the icon of the tune, then press the shift
  88.     key and hold it down while double clicking on the PlaySID icon.
  89.  
  90.     If you want to run this utility from CLI/Shell, just put the
  91.     directory containing PlaySID in your path (e.g. c: ) and then
  92.     write: PlaySID [<tune directory>/<tune name>]
  93.  
  94.     PlaySID need a special font. Include playsid.font in your FONT:
  95.     directory.
  96.  
  97.     The "Setup" icon will copy the main program to RAM: and assign
  98.     it to SID:. After selecting this icon you only have to double-
  99.     click on the icon of the tune you want to play.
  100.  
  101.  
  102. PROGRAM USAGE:
  103.  
  104.     It works almost like an ordinary cassette player, with the
  105.     symbols for play, forward, rewind, pause and stop. While PlaySID
  106.     is active you can just drag a tune icon and drop it on the
  107.     PlaySID window. To most commands there are keyboard shortcuts.
  108.  
  109.     l - Play
  110.     p - Pause
  111.     s - Stop
  112.     t - Next
  113.     T - Preview
  114.     o - Open
  115.  
  116.     The menu have more options like about, open, quit, filter and
  117.     rewind.    The filter option turns on and off the amiga sound filter.
  118.     Please try it.
  119.  
  120.  
  121. REWIND BUTTON:
  122.  
  123.     If the rewind option is turned on, the rewind gadget will be
  124.     enabled first when you press the play gadget. The rewind routines
  125.     are very complex and need a lot of memory. Thats the reason of the
  126.     option. It takes approximately 30k every minute of playing.
  127.  
  128.  
  129. POWERPACKER SUPPORT:
  130.  
  131.     Version 2.2 of PlaySID and above support powerpacked files. If
  132.     PlaySID    finds "powerpacker.library", it won't tell you if it failed,
  133.     all file loading is done through it. To save space you can now
  134.     crunch all your files.
  135.  
  136.  
  137. ONE-FILE FORMAT:
  138.  
  139.     Many users requested a new "one file" format of PlaySID data files.
  140.     The file SIDConv on the disk will convert a regular data+icon file
  141.     to the new one-file format. A utility that will do the opposite
  142.     will soon be released. Of course these new files can be crunched
  143.     as well.
  144.  
  145.     SIDConv oldfile newfile
  146.  
  147.  
  148. AREXX PORT:
  149.  
  150.     PlaySID now have an Arexx Port named 'PLAYSID'. This mean that
  151.     you now have full controll of PlaySID through your arexx scripts.
  152.     Supplied with this release are two examples of what you can do
  153.     with arexx:
  154.  
  155.     Jukebox - This will take given file as input and play each
  156.           song the amount of time given.
  157.  
  158.           Try: Jukebox.rexx JukeDemo
  159.  
  160.     Preview - This will play each tune in given song for 10 sec.
  161.           Like the preview found in CD Players.
  162.  
  163.           Try: Preview.rexx Songs/RunTheGauntlet
  164.  
  165.     Arexx commands supported:
  166.  
  167.     SID_PLAY()      - Start current tune
  168.     SID_PAUSE()      - Pause current tune
  169.     SID_STOP()      - Stop current tune
  170.     SID_QUIT()      - Quit PlaySID
  171.     SID_LOAD(song)      - Load <song> into PlaySID
  172.     SID_SETTUNE(tune) - Set <tune> to current one
  173.     SID_NUMTUNES()      - return number of tunes
  174.  
  175.  
  176. TECHNICAL INFO:
  177.  
  178.     Up to date PlaySID features:
  179.  
  180.     * Full emulation of valid 6502 instructions
  181.     * Full envelope emulation (even better than SID)
  182.     * Full waveform emulation (uses highest quality ever possible)
  183.     * Full ringmodulation/synchronize emulation (even both!)
  184.     * Emulation of the fourth channel, including Martin Galway NOISE
  185.       and all kind of SAMPLES
  186.     * Sounding like C64 PAL even on Amiga NTSC (the right sound)
  187.     * Handle 50Hz, 60Hz and variable speed timing
  188.     * Fast Forward
  189.     * Timer
  190.     * Amiga 4 kHz Filter ON/OFF (Should be off!)
  191.     * Full TRUE Multitasking (Opens, Closes and Checks everything)
  192.     * Above new feutures
  193.  
  194.     PlaySID is written with Emacs 18.58 and compiled with SAS/C 6.0
  195.     and Devpac 3.0 assembler. The user interface was designed with
  196.     Toolmaker. It uses about 50kB of chip memory and 160kB of other
  197.     memory. If playing samples or rewind option is on, more memory
  198.     will be used. Also add the length of the tune to the amount of
  199.     other memory.
  200.  
  201.  
  202. TOOL TYPE INFO:
  203.  
  204.     Syntax of the Tool-Types of <tune>.info:
  205.  
  206.        ADDRESS = <loadaddress>,<initaddress>,<playaddress> ;in hex
  207.  
  208.     loadaddress should be the C64 adress where the file should
  209.     be loaded. If 0 is specified, the first two bytes of the file
  210.     will instead be used as loadaddress.
  211.     
  212.     initaddress should point to a subroutine which initializes the
  213.     songnr in accumulator (starting with $00). If 0 is specified,
  214.     then the initaddress will be the first C64 address loaded.
  215.  
  216.     playaddress should point to a subroutine which plays a note of
  217.     the song. This will be called as often as described in the speed
  218.     parameter. If 0 is specified, then the playaddress will be the
  219.     address of the interrupt initialized by the subroutine at the
  220.     initaddress. This address will be the contents of $0314/0315 or
  221.     $FFFE/FFFF depending on what value $0001 contains.
  222.  
  223.        SONGS = <nr of songs>,[<start song nr>] ;in dec
  224.  
  225.        SPEED = <speeddata> ;in hex
  226.  
  227.     speeddata contains info about playspeed. For each song a bit
  228.     is reserved, bit 0 for song nr 1 and so on. A 0 bit means 50 Hz
  229.     and a 1 bit means 60 Hz or the time set in $DC04/05.
  230.  
  231.        NAME = <name of the tune> ;in ascii
  232.  
  233.        AUTHOR = <name of the author> ;in ascii
  234.  
  235.        COPYRIGHT = <name of the copyright owner> ;in ascii
  236.  
  237.  
  238. FUTURE FEATURES:
  239.  
  240.     This is a list of features that still isn't included into the current
  241.     version. They will probably be included in future versions.
  242.  
  243.     * Emulation of Filter.
  244.     * Option to get a window or screen with special musicinfo.
  245.     * Option to load and play Tunes which are already emulated.
  246.     * Option to Sound like C64 NTSC for American users who like NTSC.
  247.     * Option to load and show KOALA pictures.
  248.     * Option to load SID songs.
  249.     * Features YOU would like to be added (PLEASE WRITE AND TELL US).
  250.  
  251.  
  252. CONVERSION:
  253.  
  254.     If you convert by yourselve, PLEASE send them to us, using e-mail
  255.     or regular mail, so we can release complete packages. Then the
  256.     user will not get several packages with same or bad tunes.
  257.  
  258.     If you want to help us with conversion, we would be very pleased.
  259.     We have a lot of disks on 1541-format and Amiga-format with already
  260.     ripped tunes. On a lot of the files, the only work to do, is to
  261.     find the addresses of the initroutines. Some of them are splitted
  262.     in several files but the most of them are one-parted. If you don't
  263.     have a C64 anymore but still have the knowledge of 6502, we could
  264.     also supply you with a fast C64emulator with a machinecodemonitor
  265.     made by ourselves. If you would want these files, please send some
  266.     blank disks (in either format) to any address belove. If it shows
  267.     up that you are a good converter, then you will have the next
  268.     updates for free.
  269.  
  270.     For more information about conversion, read the special docs.
  271.  
  272.  
  273. REGISTRATION:
  274.  
  275.     If you want to support our work you have the option to become a
  276.     registered owner of this utility and receive further upgrades.
  277.     Send around $15 USD (US DOLLAR) or equal amount in SEK (Swedish
  278.     Krona) or DM (German Mark). Send it to eihter address below with
  279.     your name, address, e-mail etc. If you later change address,
  280.     please let us know.
  281.  
  282.         Ron Birk        Håkan Sundell
  283.         Krögarvägen 11        Drakblommegatan 19
  284.         145 52 Norsborg        417 20 Göteborg
  285.         SWEDEN            SWEDEN
  286.  
  287.     If you want to phone us about suggestions or complains about
  288.     PlaySID you may call:
  289.  
  290.     +46 (0)31 227248 (Håkan) about 6502 and SID emulation
  291.     +46 (0)8 53188626 (Ron) about User interface and Arexx
  292.  
  293.     If you have access to Internet you will reach us at the following
  294.     e-mail address:
  295.  
  296.     d89-rbi@nada.kth.se
  297.  
  298.       or
  299.  
  300.     nadg-23@student.cs.chalmers.se
  301.  
  302.  
  303. NOTE TO OTHER DEVELOPERS:
  304.  
  305.     To Questronix (The makers of The A64 Package):
  306.  
  307.     We are still offering you our SID emulation to your
  308.     C64 Emulator (We have listened to your noise emulation).
  309.     And if that is interresting, we could help with the Cassette
  310.     interface (including software) too! It's connected as a diskdrive,
  311.     and it works very fine.
  312.  
  313.  
  314. THANKS:
  315.  
  316.     We want to thank the following people for helping us with the
  317.     development of PlaySID:
  318.  
  319.     Robert Eichelsheim   - For supporting us with extremely many ripped
  320.                    tunes and for information about the authors
  321.                    and copyrights. For beta testings and good
  322.                    suggestions about improvements.
  323.  
  324.     Bent Nielsen         - For supporting good ideas and algorithms
  325.                    about synthesized waveforms.
  326.  
  327.     Alexander Andelkovic - For lending us your C64, 1541 and many
  328.                    games to rip songs from.
  329.  
  330.     Stefan Boberg        - For early beta tests and good suggestions.
  331.  
  332.     Teijo Kinnunen       - For making MED! It inspired us to make
  333.                    PlaySID multitask.
  334.  
  335.     Olaf Barthel         - For making Term! Without it we would still
  336.                    use snail mail during development, as we
  337.                    live 460 km from each other.
  338.  
  339.     Registered Users     - Thanks for supporting our work. You are
  340.                    the reason for our work.
  341.  
  342.     Commodore-Amiga      - For making all this possible!
  343.  
  344.  
  345. LAST WORDS:
  346.  
  347.     We hope that you will find this program useful and that
  348.     it will bring back the old C64 athmosphere to you too...
  349.  
  350.  
  351.